home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / pio_badaddr.z / pio_badaddr
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ppppiiiioooo____bbbbaaaaddddaaaaddddddddrrrr((((DDDD3333XXXX))))                                              ppppiiiioooo____bbbbaaaaddddaaaaddddddddrrrr((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr - test for valid input bus address
  10.      _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll - test for valid input bus address and return value
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_pppp_iiii_oooo_...._hhhh_>>>>
  16.  
  17.      _iiii_nnnn_tttt _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr_((((_pppp_iiii_oooo_mmmm_aaaa_pppp______tttt_**** _p_i_o_m_a_p_,,,, _iiii_oooo_pppp_aaaa_dddd_dddd_rrrr______tttt _i_o_p_a_d_d_r_,,,, _iiii_nnnn_tttt _s_i_z_e_))))_;;;;
  18.      _iiii_nnnn_tttt _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll _((((_pppp_iiii_oooo_mmmm_aaaa_pppp______tttt_**** _p_i_o_m_a_p_,,,, _iiii_oooo_pppp_aaaa_dddd_dddd_rrrr______tttt _i_o_p_a_d_d_r_,,,, _iiii_nnnn_tttt _s_i_z_e_,,,, _vvvv_oooo_iiii_dddd _****_p_t_r_))))_;;;;
  19.  
  20.    AAAArrrrgggguuuummmmeeeennnnttttssss
  21.      _p_i_o_m_a_p
  22.           A PIO map returned from _pppp_iiii_oooo______mmmm_aaaa_pppp_aaaa_llll_llll_oooo_cccc(D3X).
  23.  
  24.      _i_o_p_a_d_d_r
  25.           The I/O bus address to be probed.
  26.  
  27.      _s_i_z_e The size in bytes to probe the I/O bus address, 1, 2, or 4.
  28.  
  29.      _p_t_r  Address of a variable of the appropriate _s_i_z_e (char, short, or int)
  30.           into which the value read is placed.
  31.  
  32. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.      Typically these functions are called from a I/O bus device driver's
  34.      _iiii_nnnn_iiii_tttt(D2) or _eeee_dddd_tttt_iiii_nnnn_iiii_tttt(D2) function to determine whether a device is present
  35.      in the system.
  36.  
  37.      Call _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr to determine whether you can read a specified bus
  38.      address.  If you are also going to use the value returned from that
  39.      address, use _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll, thus saving one uncached read to fetch the
  40.      value.
  41.  
  42.      Use _pppp_iiii_oooo______wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr(D3X) to validate a bus address for output.
  43.  
  44. NNNNOOOOTTTTEEEESSSS
  45.      Passing an invalid _s_i_z_e will result in a system panic.
  46.  
  47.      It is possible that the _pppp_iiii_oooo______bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll(D3X) function may change or be
  48.      removed in the future.
  49.  
  50.      These routines may not be called from an interrupt handler or from
  51.      routines that may be called from an interrupt handler.
  52.  
  53.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  54.      Both functions return 0 when the address is valid, and nonzero when it is
  55.      invalid.
  56.  
  57.    SSSSeeeeeeee AAAAllllssssoooo
  58.      pio_bcopyin(Da3x), pio_mapalloc(D3X), pio_wbadaddr(D3X).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.